home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d20 / sysl_20.arc / SYSLIST.DOC < prev    next >
Encoding:
Text File  |  1991-09-27  |  13.2 KB  |  330 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.               
  22.  
  23.  
  24.  
  25.           ╒══════════════════════════════════════════════════════════╕
  26.           │                                                          │
  27.           │                       SysList 2.0                        │
  28.           │                Master File List Compiler                 │
  29.           │  Copyright (C) 1991 Chris Bugosh.  All rights reserved.  │
  30.           │                                                          │
  31.           ╘══════════════════════════════════════════════════════════╛
  32.  
  33.  
  34.  
  35.  
  36. ╒════════════╤════════════════════════════════════════════════════╤════════════╕
  37. │░░░▒▒▒▓▓▓███│                  What is SysList                   │███▓▓▓▒▒▒░░░│
  38. ╘════════════╧════════════════════════════════════════════════════╧════════════╛
  39.  
  40. SysList is a "universal" file list compiler.  Some of the features are :
  41.  
  42. - Can be used on any BBS that uses the FILES.BBS file for file listings, as well
  43.   as TBBS systems.
  44. - Menu driven configuration with mouse support.
  45. - Three customizable information files.  Two can go at the top of your file list
  46.   as well as one at the end.
  47. - Toggling of file dates and sizes in the list.
  48. - Toggling of area summaries including total files and total bytes.
  49. - Upper/Lower/"Proper" case file names
  50. - Summary at bottom of list of all the file areas.
  51. - Marking of files in the main list that are considered new.
  52. - Description adding for files without descriptions
  53. - ANSI/ASCII bulletin summaries.
  54.  
  55. ╒════════════╤════════════════════════════════════════════════════╤════════════╕
  56. │░░░▒▒▒▓▓▓███│             Legal Stuff and Disclaimer             │███▓▓▓▒▒▒░░░│
  57. ╘════════════╧════════════════════════════════════════════════════╧════════════╛
  58.  
  59. This package is Shareware. This means, this software is user supported and if
  60. used more than 30 days, must be registered.
  61.  
  62. The author make no warranties, expressed or implied, as to the performance of
  63. this program. The author will not be held liable for any direct, indirect,
  64. incidental or consequential damages resulting from the use of this program.
  65. Your use of the program confirms that you agree with the statements stated
  66. above.
  67.  
  68. In short, the above says you have to register the program after 30 days, and if
  69. you run the program at all, you acknowledge that you will not hold the author
  70. responsible for anything.
  71.  
  72. ╒════════════╤════════════════════════════════════════════════════╤════════════╕
  73. │░░░▒▒▒▓▓▓███│                    Registration                    │███▓▓▓▒▒▒░░░│
  74. ╘════════════╧════════════════════════════════════════════════════╧════════════╛
  75.  
  76. The registration procedure is easy.  Fill out the registration form and with
  77. $15.00 (American Dollars) send it to :
  78.  
  79.                           Chris Bugosh
  80.                           5506 Cedarbush Road
  81.                           Columbus, Ohio 43229
  82.                           U.S.A
  83.  
  84. * Exception to the above.  If you are a shareware author, I will exchange a
  85.   registered version of this program, for one of yours.
  86.  
  87. You get no special version for being registered.  You just keep SysList alive
  88. for a little longer.  The version you have is not limited in anyway.  This idea
  89. has worked for other authors, so I decided to try it.
  90.  
  91. Keep the idea of shareware alive, register ALL your programs.
  92.  
  93. ╒════════════╤════════════════════════════════════════════════════╤════════════╕
  94. │░░░▒▒▒▓▓▓███│               Files in this Archive                │███▓▓▓▒▒▒░░░│
  95. ╘════════════╧════════════════════════════════════════════════════╧════════════╛
  96.  
  97. The only files that are to be in this archive are:
  98.  
  99.       CONVERT.ZIP  - Compressed file with converting programs
  100.        - MAX2SYS.EXE  - Convert Opus/Maximus AREAS.CTL to SysList
  101.        - Q2SYS.EXE    - Convert QuickBBS/SuperBBS/RemoteAccess to SysList
  102.        - CONVERT.DOC  - Quick documentation for MAX2SYS/Q2SYS/100TO200
  103.        - 100TO200.EXE - Convert SysList 1.0 configuration to SysList 2.0
  104.       SLCONFIG.EXE - Configuration program
  105.       SYSLIST.CFG  - Sample configuration file
  106.       SYSLIST.DOC  - The docs that you are reading now
  107.       SYSLIST.EXE  - The main SysList program
  108.       SYSLIST.LST  - Sample file area configuration file
  109.       SYSLIST.REG  - SysList registration form
  110.  
  111. If there are any more, or any of the files are missing, the archive has been
  112. tampered with.
  113.  
  114. ╒════════════╤════════════════════════════════════════════════════╤════════════╕
  115. │░░░▒▒▒▓▓▓███│               Setting up the Program               │███▓▓▓▒▒▒░░░│
  116. ╘════════════╧════════════════════════════════════════════════════╧════════════╛
  117.  
  118. - Main Menu
  119.  
  120.     MAIN FILES & ARCHIVING - Setup information for main file list name, header,
  121.                              footer and extra file names, bulletin toggle and
  122.                              ASCII/ANSI bulletin file names, and archiver
  123.                              selection
  124.  
  125.     BBS INFO   - Setup information for default header if you choose not to use
  126.                  one.
  127.  
  128.     NEW FILES  - Setup information for new files list name, header, footer, and
  129.                  extra file names, marking of new files in main list toggle, and
  130.                  days back to consider new.
  131.  
  132.     LIST INFO  - Setup information for misc. toggles.  Such as file sizes, file
  133.                  dates, summaries, plus more.
  134.  
  135.     FILE AREAS - Setup information for the file areas including adding,
  136.                  inserting, deleting and editing of areas.
  137.  
  138.  
  139. - Main Files & Archving
  140.  
  141.     MAIN OUTPUT FILE - This is the file that SysList will write its output into.
  142.                        Ex. C:\BBS\ALLFILES.LST
  143.  
  144.     FILE AREA FILE   - This is the file that SysList will look into for all of
  145.                        its file areas and directories.  By changing this, you
  146.                        can use SysList many times with different file areas.
  147.                        (For instance, a "Games Only" file list.)
  148.                        Ex. C:\BBS\SYSLIST.LST
  149.  
  150.     MAIN HEADER FILE - This is the file that SysList puts into the main list
  151.                        first, before anything else.  In most lists, this
  152.                        contains information about your BBS.  (A default one
  153.                        can be made. (See BBS Information later in
  154.                        documentation.)
  155.                        Ex. C:\BBS\SYSLIST.HDR
  156.  
  157.     MAIN EXTRA FILE  - This file is put after the the header and date.  This
  158.                        file can be used for anything you'd like.
  159.                        Ex. C:\BBS\SYSLIST.EXT
  160.  
  161.     MAIN FOOTER FILE - This file is put near the end of the file.  This could
  162.                        possibly contain some closing information.
  163.                        Ex. C:\BBS\SYSLIST.FOT
  164.  
  165.     MAKE BULLETINS   - If you'd like SysList to make ANSI/ASCII summary files,
  166.                        set this to YES.
  167.  
  168.     ARCHIVER         - This is for setting up the archiver (If any) to use on
  169.                        both the main list and new files list.  Syslist supports
  170.                        the following compression programs :
  171.  
  172.                        NONE   - Don't compress the lists.
  173.                        ARJ    - Copyright Robert K. Jung
  174.                        LHARC  - Copyright Haruyasu Yoskizaki
  175.                        PKPAK  - Copyright PKware Inc.
  176.                        PKXARC - Copyright PKware Inc.
  177.                        PKZIP  - Copyright PKware Inc.
  178.                        ZOO    - Copyright Rahul Dhesi
  179.  
  180.                        The one you choose must be either in your path or in the
  181.                        current directory.  You may also choose to move the files
  182.                        into the compression file.
  183.  
  184.  
  185. - BBS Info (For default header)
  186.  
  187.   The following information is for if you want to modify the header a little.
  188.   For instance, BBS Name doesn't NEED to be your BBS's name, that's just my
  189.   suggestion.
  190.  
  191.     NAME               - First line in default header.
  192.  
  193.     SYSOP              - Second line in default header.
  194.  
  195.     PHONE NUMBER(S)    - Fourth line in default header.
  196.  
  197.     BAUD RATE(S)       - Fifth line in default header.
  198.  
  199.     NETWORK ADDRESS(S) - Third line in default header.
  200.  
  201.  
  202. - New Files
  203.  
  204.     NEW OUTPUT FILE - This is the file that SysList will write its new files
  205.                       into.
  206.                       Ex. C:\BBS\ALLFILES.LST
  207.  
  208.     NEW HEADER FILE - This is the file that SysList puts into the new files list
  209.                       first, before anything else.  In most lists, this
  210.                       contains information about your BBS.  (A default one
  211.                       can be made. (See BBS Information ealier in
  212.                       documentation.)
  213.                       Ex. C:\BBS\NSYSLIST.HDR
  214.  
  215.     NEW EXTRA FILE  - This file is put after the the header and date.  This
  216.                       file can be used for anything you'd like.
  217.                       Ex. C:\BBS\NSYSLIST.EXT
  218.  
  219.     NEW FOOTER FILE - This file is put near the end of the file.  This could
  220.                       possibly contain some closing information.
  221.                       Ex. C:\BBS\NSYSLIST.FOT
  222.  
  223.     NEW DAYS CUTOFF - This is the days back to consider new.
  224.                       Ex. 7 for "Files are 7 days old" etc.
  225.  
  226.     MARK NEW FILES IN MAIN LIST - If you want files that are new marked with
  227.                                   a character in your main list, set this to
  228.                                   YES.
  229.  
  230.     NEW FILES MARKING CHARACTER - If you have the above set to YES, this will
  231.                                   be the character that is put next to each new
  232.                                   file.  (Supports High ASCII Characters)
  233.                                   Ex. *
  234.  
  235.  
  236. - List Info
  237.  
  238.     FILE DATES          - If you want each file's date in the list, set this to
  239.                           YES.
  240.  
  241.     FILE SIZE           - If you want each file's size in the list, set this to
  242.                           YES.
  243.  
  244.     ADD DESCRIPTIONS    - If you want to add a default description for each file
  245.                           the doesn't have one, set this to YES.
  246.  
  247.     MISSING DESCRIPTION - Description if the ADD DESCRIPTIONS is set to YES.
  248.  
  249.     FILE TOTALS         - If you want total files at the end of each area and
  250.                           the bottom of the list, set this to YES.
  251.  
  252.     KBYTE TOTALS        - If you want total bytes at the end of each area and
  253.                           the bottom of the list, set this to YES.
  254.  
  255.     SHOW TOTALS         - If you want a summary of all of your areas at the end
  256.                           of your list, set this to YES.
  257.  
  258.     SHOW MISSING FILES  - If you want SysList to add files that are in your
  259.                           FILES.BBS and not in the directory, set this to YES.
  260.  
  261.     FILE NAMES CASE     - This allows you to change the case of the file names
  262.                           in the list.
  263.                           Ex.
  264.                               Upper  - FILENAME.EXT
  265.                               Lower  - filename.ext
  266.                               Proper - Filename.Ext
  267.  
  268.     TBBS SYSTEM         - Tells SysList whether you are running TBBS or not.
  269.  
  270.  
  271. - File Areas
  272.  
  273.   For all of the following options, the following limitations are set :
  274.  
  275.   - File area names can not exceed 49 characters.
  276.  
  277.   - If you are running TBBS, you must put the filename that contains the file
  278.     information for each directory.
  279.     Ex. C:\BBS\UTILS\FILES.DIR
  280.  
  281.   - If you are not running TBBS, FILES.BBS is assumed, so you should not put
  282.     that on the directory line.
  283.     Ex. C:\BBS\UTILS\
  284.   
  285.  
  286.     ADD AN AREA    - This allows you to add an area at the end of the list.
  287.  
  288.     EDIT AN AREA   - This allows you to edit any area's configuration.
  289.  
  290.     LIST AREAS     - Allows you to view all of your file areas.  The directory
  291.                      is shown at the bottom of the screen.
  292.  
  293.     DELETE AN AREA - Allows you to delete a single area or multiple file areas.
  294.                      To delete, you must first mark the area(s) you want to
  295.                      delete by hitting the space bar, then hitting enter.
  296.  
  297.     INSERT AN AREA - This allows you to insert a file area before another file
  298.                      area.
  299.  
  300.  
  301. ╒════════════╤════════════════════════════════════════════════════╤════════════╕
  302. │░░░▒▒▒▓▓▓███│                Running the Program                 │███▓▓▓▒▒▒░░░│
  303. ╘════════════╧════════════════════════════════════════════════════╧════════════╛
  304.  
  305. SysList can be run one of two ways.  The first, will use SYSLIST.CFG and only
  306. SYSLIST.CFG.  To run it this way, all that is needed on the command line is :
  307.  
  308. SYSLIST or
  309. SLCONFIG
  310.  
  311. If you'd like to use multiple configurations, you can do this by typing in,
  312. at the command line :
  313.  
  314. SYSLIST <config name> or
  315. SLCONFIG <config name>
  316.  
  317. Ex. SYSLIST SDS.CFG
  318.     SLCONFIG SDS.CFG
  319.  
  320. ╒════════════╤════════════════════════════════════════════════════╤════════════╕
  321. │░░░▒▒▒▓▓▓███│               Contacting the Author                │███▓▓▓▒▒▒░░░│
  322. ╘════════════╧════════════════════════════════════════════════════╧════════════╛
  323.  
  324. The author can be contacted by US Snail mail to the address stated above, or any
  325. of the following means :
  326.  
  327.                               1:226/30 - Fido-Net
  328.                            BBS Number - 614-846-1274
  329.                              CompuServe - 76247,152
  330.